✔️ Deploy Preview for osdocs ready!

🔨 Explore the source changes: 2e9b9d8

🔍 Inspect the deploy log: https://app.netlify.com/sites/osdocs/deploys/61fadd697402d80007075a8e

😎 Browse the preview: https://deploy-preview-39854--osdocs.netlify.app

@vikram-redhat Given the nature of this change, I am asking that you peer review this. I was thinking that it might be a good idea to begin adoption of text snippets with 4.10 to avoid any issues that might arise going as far back as 4.6. WDYT?

@mjpytlak this works for me.

Do you mean to say that you will merge this only for 4.10?

Yes. I am proposing that we adopt text snippets as of 4.10. I was concerned about back porting and running into issues. Am I overthinking it?

@vikram-redhat, this doesn't count as a module in the CCS guidelines and is thus permissible? Or are we not concerned about that any longer. For all intents in purposes, this is just structured use of an include. And if we were just docs.openshift.com, I'd say go for it. But because we have other concerns, I wonder about this if adopted at scale.

Good morning, @jboxman-rh. If you have not had a chance, PTAL at #38393. I had updated our guidelines around usage.

@jboxman I don't think there are any issues around using text snippets, in any platform. @kalexand-rh can you confirm if Jupiter has any restrictions on this?

@mjpytlak if we do merge it, I think we should backport it to avoid conflicts.

@vikram-redhat, well, a snippet is just an include. So this all formalizes what to Asciidoctor is just a thing, that it does. But it isn't necessarily a thing every 'platform' will do, so I don't want to keep digging if it presents an issue.

@vikram-redhat, Jupiter doesn't care if you use snippets. It's just another include. I don't think they've decided if they're going to store it as a separate node, but they've confirmed that snippets will be transformed correctly during the ingest phase.

well, a snippet is just an include. So this all formalizes what to Asciidoctor is just a thing, that it does. But it isn't necessarily a thing every 'platform' will do, so I don't want to keep digging if it presents an issue.

You are right. We know how it can be with other "platforms" :).

@kalexand-rh Rebased and resolved references to modules/technology-preview.adoc Based on Vikram's comments, I believe he was suggesting this be back ported, but he did not say how far back. I am presuming he meant all the way back to 4.6.

@mjpytlak, moving this back to 4.6 will be best.